Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 1 - Introduction to QuickDraw 3D / QuickDraw 3D Reference

QuickDraw 3D Routines / Managing Strings

Q3CString_New

You can use the Q3CString_New function to create a new C string.

TQ3StringObject Q3CString_New (const char *string);

string

A pointer to a null-terminated C string.

DESCRIPTION

The Q3CString_New function returns, as its function result, a new string object of type kQ3StringTypeCString using the sequence of characters pointed to by the string parameter. That sequence of characters should be a standard C string (that is, an array of characters terminated by the null character). The characters are copied into the new string object's private data, so you can dispose of the array pointed to by the string parameter if Q3CString_New returns successfully. If Q3CString_New cannot allocate memory for the string, it returns the value NULL.